Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Working With Progress and Cover Functions

SetMovieCoverProcs

The SetMovieCoverProcs function allows you to set both types of cover functions.

pascal void SetMovieCoverProcs (Movie theMovie, 
                                 MovieRgnCoverProc uncoverProc,
                                 MovieRgnCoverProc coverProc,
                                 long refcon);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

uncoverProc

Points to a cover function. This function is called whenever one of your movie's tracks is removed from the screen or resized, revealing a previously hidden screen region. If you want to remove the cover function, set this parameter to nil. When the uncoverProc parameter is nil, SetMovieCoverProcs uses the default cover or uncover function. The default cover function does nothing. The default uncover function erases the uncovered area. See "Cover Functions" beginning on page 2-336 for the interface your cover function must support.

coverProc

Points to a cover function. The Movie Toolbox calls this function whenever one of your movies covers a portion of the screen. If you want to remove the cover function, set this parameter to nil. See "Cover Functions" beginning on page 2-336 for the interface your cover function must support.

refcon

Specifies a reference constant. The Movie Toolbox passes this value to your cover functions.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid